Skip to content

ref(node): Streamline vendored mysql instrumentation#21568

Merged
mydea merged 12 commits into
developfrom
ref/streamline-mysql
Jun 29, 2026
Merged

ref(node): Streamline vendored mysql instrumentation#21568
mydea merged 12 commits into
developfrom
ref/streamline-mysql

Conversation

@mydea

@mydea mydea commented Jun 16, 2026

Copy link
Copy Markdown
Member

Streamlines the vendored @opentelemetry/instrumentation-mysql (#20738), mirroring the already-streamlined mysql2 sibling.

Changes

  • Step 4 (Sentry APIs): span creation moves from the OTel tracer to startInactiveSpan, with the auto.db.otel.mysql origin set directly (new — matches mysql2; the existing tests don't assert origin).
  • Step 2 (remove unused):
    • Connection-pool metrics (db.client.connections.usage counter, pool event listeners, _patchPoolEnd/_patchAdd/_setPoolCallbacks, getPoolNameOld) — Sentry doesn't consume OTel metrics.
    • Semconv-stability dual-emission — collapsed to the default OLD attribute set (db.system/db.name/db.user/db.statement, net.peer.name/net.peer.port), which is what's emitted today.
    • The unused enhancedDatabaseReporting option (the public mysqlIntegration() can't set it) + getDbValues/AttributeNames; MySQLInstrumentationConfig collapses to InstrumentationConfig (so types.ts/AttributeNames.ts are deleted).
  • Step 3 (lint): removed /* eslint-disable */ from all vendored files; they pass the type-aware linter via the shared vendored override.

The OTel context plumbing (trace.setSpan/context.with/context.bind + the pool getConnection context propagation) is intentionally kept to minimize behavior change.

Verification

  • Build + type-aware lint clean.
  • No change to emitted spans. The existing mysql integration tests (step 1, already present) cover the query/callback/stream paths against a real MySQL. Since Docker isn't available in my environment I couldn't run them locally, but a fake-connection smoke test confirms the span output is unchanged:
    op: 'db', description 'SELECT 1 + 1 AS solution' (from db.statement), origin: 'auto.db.otel.mysql', db.system/net.peer.name/net.peer.port/db.user as asserted by the tests.

Closes #20738

@github-actions

github-actions Bot commented Jun 16, 2026

Copy link
Copy Markdown
Contributor

size-limit report 📦

⚠️ Warning: Base artifact is not the latest one, because the latest workflow run is not done yet. This may lead to incorrect results. Try to re-run all tests to get up to date results.

Path Size % Change Change
@sentry/browser 27.48 kB - -
@sentry/browser - with treeshaking flags 25.91 kB - -
@sentry/browser (incl. Tracing) 45.97 kB - -
@sentry/browser (incl. Tracing + Span Streaming) 47.72 kB - -
@sentry/browser (incl. Tracing, Profiling) 50.76 kB - -
@sentry/browser (incl. Tracing, Replay) 85.22 kB - -
@sentry/browser (incl. Tracing, Replay) - with treeshaking flags 74.81 kB - -
@sentry/browser (incl. Tracing, Replay with Canvas) 89.91 kB - -
@sentry/browser (incl. Tracing, Replay, Feedback) 102.57 kB - -
@sentry/browser (incl. Feedback) 44.66 kB - -
@sentry/browser (incl. sendFeedback) 32.26 kB - -
@sentry/browser (incl. FeedbackAsync) 37.4 kB - -
@sentry/browser (incl. Metrics) 28.54 kB - -
@sentry/browser (incl. Logs) 28.78 kB - -
@sentry/browser (incl. Metrics & Logs) 29.47 kB - -
@sentry/react 29.27 kB - -
@sentry/react (incl. Tracing) 48.28 kB - -
@sentry/vue 32.63 kB - -
@sentry/vue (incl. Tracing) 47.84 kB - -
@sentry/svelte 27.5 kB - -
CDN Bundle 29.89 kB - -
CDN Bundle (incl. Tracing) 47.89 kB - -
CDN Bundle (incl. Logs, Metrics) 31.44 kB - -
CDN Bundle (incl. Tracing, Logs, Metrics) 49.24 kB - -
CDN Bundle (incl. Replay, Logs, Metrics) 70.78 kB - -
CDN Bundle (incl. Tracing, Replay) 85.4 kB - -
CDN Bundle (incl. Tracing, Replay, Logs, Metrics) 86.68 kB - -
CDN Bundle (incl. Tracing, Replay, Feedback) 91.19 kB - -
CDN Bundle (incl. Tracing, Replay, Feedback, Logs, Metrics) 92.45 kB - -
CDN Bundle - uncompressed 88.94 kB - -
CDN Bundle (incl. Tracing) - uncompressed 145.03 kB - -
CDN Bundle (incl. Logs, Metrics) - uncompressed 93.65 kB - -
CDN Bundle (incl. Tracing, Logs, Metrics) - uncompressed 149 kB - -
CDN Bundle (incl. Replay, Logs, Metrics) - uncompressed 218.62 kB - -
CDN Bundle (incl. Tracing, Replay) - uncompressed 264.05 kB - -
CDN Bundle (incl. Tracing, Replay, Logs, Metrics) - uncompressed 268 kB - -
CDN Bundle (incl. Tracing, Replay, Feedback) - uncompressed 277.75 kB - -
CDN Bundle (incl. Tracing, Replay, Feedback, Logs, Metrics) - uncompressed 281.69 kB - -
@sentry/nextjs (client) 50.67 kB - -
@sentry/sveltekit (client) 46.37 kB - -
@sentry/core/server 77.54 kB - -
@sentry/core/browser 63.88 kB - -
@sentry/node-core 61.51 kB -0.01% -1 B 🔽
@sentry/node 123.08 kB -0.34% -411 B 🔽
@sentry/node/import (ESM hook with diagnostics-channel injection) 69.95 kB - -
@sentry/node/light 50.4 kB - -
@sentry/node - without tracing 73.61 kB - -
@sentry/aws-serverless 84.4 kB -0.01% -1 B 🔽
@sentry/cloudflare (withSentry) - minified 180.31 kB - -
@sentry/cloudflare (withSentry) 446.24 kB - -

View base workflow run

mydea added a commit that referenced this pull request Jun 24, 2026
…21684)

This updates the node-integration-tests for `mysql` package for better
test coverage (in preparation of
#21568), as well as
also fixing some holes in the tests:

* Previously, we did not have any MySQL server, which lead to some weird
quirks, e.g. spans being marked as failed because no server is found
etc. This kind of skewed the results. This PR introduces a minimal,
node-written MySQL server that only replies with OK/ERROR, just enough
for our tests.
* Add tests for connection pooling
* Add tests for streamed query errors
* Add tests for context stability in streamed queries
@mydea
mydea force-pushed the ref/streamline-mysql branch from 2b3d982 to 23da82a Compare June 25, 2026 09:14

@cursor cursor Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Cursor Bugbot has reviewed your changes and found 1 potential issue.

Fix All in Cursor

❌ Bugbot Autofix is OFF. To automatically fix reported issues with cloud agents, enable autofix in the Cursor dashboard.

Reviewed by Cursor Bugbot for commit 23da82a. Configure here.

@mydea
mydea marked this pull request as ready for review June 26, 2026 09:19
@mydea
mydea requested a review from a team as a code owner June 26, 2026 09:19
@mydea
mydea requested review from JPeer264 and andreiborza and removed request for a team June 26, 2026 09:19
andreiborza added a commit that referenced this pull request Jun 26, 2026
Under the SentryTracerProvider, streamed spans carry `sentry.origin` as a
first-class attribute including the default `manual` value, whereas the
OpenTelemetry SDK path omits the `manual` default. The `mysql` (v1) db spans
and the `pg.connect` span set no explicit origin, so they surface as
`manual` here.

Assert it for now. When those instrumentations are reworked to set an
explicit `auto.db.otel.*` origin (e.g. #21568 for mysql), these expectations
will be updated to the real origin then.
Comment thread packages/node/src/integrations/tracing/mysql/vendored/instrumentation.ts Outdated
andreiborza added a commit that referenced this pull request Jun 26, 2026
Under the SentryTracerProvider, streamed spans carry `sentry.origin` as a
first-class attribute including the default `manual` value, whereas the
OpenTelemetry SDK path omits the `manual` default. The `mysql` (v1) db spans
and the `pg.connect` span set no explicit origin, so they surface as
`manual` here.

Assert it for now. When those instrumentations are reworked to set an
explicit `auto.db.otel.*` origin (e.g. #21568 for mysql), these expectations
will be updated to the real origin then.
andreiborza added a commit that referenced this pull request Jun 27, 2026
Under the SentryTracerProvider, streamed spans carry `sentry.origin` as a
first-class attribute including the default `manual` value, whereas the
OpenTelemetry SDK path omits the `manual` default. The `mysql` (v1) db spans
and the `pg.connect` span set no explicit origin, so they surface as
`manual` here.

Assert it for now. When those instrumentations are reworked to set an
explicit `auto.db.otel.*` origin (e.g. #21568 for mysql), these expectations
will be updated to the real origin then.
andreiborza added a commit that referenced this pull request Jun 27, 2026
Under the SentryTracerProvider, streamed spans carry `sentry.origin` as a
first-class attribute including the default `manual` value, whereas the
OpenTelemetry SDK path omits the `manual` default. The `mysql` (v1) db spans
and the `pg.connect` span set no explicit origin, so they surface as
`manual` here.

Assert it for now. When those instrumentations are reworked to set an
explicit `auto.db.otel.*` origin (e.g. #21568 for mysql), these expectations
will be updated to the real origin then.
andreiborza added a commit that referenced this pull request Jun 28, 2026
Under the SentryTracerProvider, streamed spans carry `sentry.origin` as a
first-class attribute including the default `manual` value, whereas the
OpenTelemetry SDK path omits the `manual` default. The `mysql` (v1) db spans
and the `pg.connect` span set no explicit origin, so they surface as
`manual` here.

Assert it for now. When those instrumentations are reworked to set an
explicit `auto.db.otel.*` origin (e.g. #21568 for mysql), these expectations
will be updated to the real origin then.
mydea and others added 12 commits June 29, 2026 10:17
Streamlines the vendored `@opentelemetry/instrumentation-mysql`, mirroring the
already-streamlined `mysql2` sibling:

* Migrate span creation from the OpenTelemetry tracer to Sentry's
  `startInactiveSpan`, and set the `auto.db.otel.mysql` span origin directly.
* Remove the connection-pool metrics (`db.client.connections.usage` counter,
  pool event listeners, `_patchPoolEnd`/`_patchAdd`/`_setPoolCallbacks`,
  `getPoolNameOld`) - Sentry does not consume OTel metrics.
* Remove the OTel semconv-stability dual-emission and keep the default (OLD)
  attribute set (`db.system`/`db.name`/`db.user`/`db.statement`,
  `net.peer.name`/`net.peer.port`), which is what the SDK emits today.
* Remove the unused `enhancedDatabaseReporting` option (the public
  `mysqlIntegration()` cannot set it) and its `getDbValues`/`AttributeNames`
  helpers; `MySQLInstrumentationConfig` collapses to `InstrumentationConfig`.
* Remove the `/* eslint-disable */` from the vendored files and make them pass
  the (type-aware) linter via the shared vendored override.

The OTel context plumbing (`trace.setSpan`/`context.with`/`context.bind` and the
pool `getConnection` context propagation) is kept as-is to minimize behavior
change. No change to emitted spans - the existing mysql integration tests cover
the query/callback/stream paths, and a fake-connection smoke test confirms the
span op/description/attributes/origin are unchanged.

Closes #20738

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
…config

Per review: don't loosen the shared `.oxlintrc` vendored override for the mysql
files; instead resolve the lint findings in the files themselves.

* `mysql-types.ts`: replace the inlined `any`s with `unknown` (index signatures,
  loose `values`/`results`, event-listener args).
* `utils.ts`: type `getConfig`'s parameter instead of `any`.
* `instrumentation.ts`: keep targeted `oxlint-disable-next-line` comments only
  where the shimmer-style wrapping genuinely needs `any`/`this`-aliasing, and
  type the remaining sites (`this: unknown`, `unknown` callback results, the
  streamed-error cast).

Lint is clean (0/0) without the base-config change. Build passes and a
fake-connection smoke test confirms the span output is unchanged.

Part of #20738

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
…origin)

The existing mysql scenarios only covered a single `createConnection` with the
callback and streamed-success paths. Add coverage for the paths the streamlining
touched:

* Assert the `auto.db.otel.mysql` span origin (previously unverified).
* `createPool` + `pool.query` (covers `_patchCreatePool` / `_patchQuery(pool)`).
* A failing streamed query, asserting the span is marked `internal_error` via the
  stream `error` event handler.

Part of #20738

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
… context

Adds a scenario that starts a span from inside a streamed query's `end` listener
and asserts it is parented to the transaction (the context active when the query
was issued), not to the query span - covering the `context.bind(parentContext,
streamableQuery)` behavior in the instrumentation.

Part of #20738

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
@mydea
mydea force-pushed the ref/streamline-mysql branch from 23da82a to 9f5416a Compare June 29, 2026 08:19
@mydea
mydea merged commit ecbd30a into develop Jun 29, 2026
356 of 358 checks passed
@mydea
mydea deleted the ref/streamline-mysql branch June 29, 2026 09:43
andreiborza added a commit that referenced this pull request Jun 29, 2026
Under the SentryTracerProvider, streamed spans carry `sentry.origin` as a
first-class attribute including the default `manual` value, whereas the
OpenTelemetry SDK path omits the `manual` default. The `mysql` (v1) db spans
and the `pg.connect` span set no explicit origin, so they surface as
`manual` here.

Assert it for now. When those instrumentations are reworked to set an
explicit `auto.db.otel.*` origin (e.g. #21568 for mysql), these expectations
will be updated to the real origin then.
andreiborza added a commit that referenced this pull request Jun 29, 2026
Under the SentryTracerProvider, streamed spans carry `sentry.origin` as a
first-class attribute including the default `manual` value, whereas the
OpenTelemetry SDK path omits the `manual` default. The `mysql` (v1) db spans
and the `pg.connect` span set no explicit origin, so they surface as
`manual` here.

Assert it for now. When those instrumentations are reworked to set an
explicit `auto.db.otel.*` origin (e.g. #21568 for mysql), these expectations
will be updated to the real origin then.
andreiborza added a commit that referenced this pull request Jun 29, 2026
Under the SentryTracerProvider, streamed spans carry `sentry.origin` as a
first-class attribute including the default `manual` value, whereas the
OpenTelemetry SDK path omits the `manual` default. The `mysql` (v1) db spans
and the `pg.connect` span set no explicit origin, so they surface as
`manual` here.

Assert it for now. When those instrumentations are reworked to set an
explicit `auto.db.otel.*` origin (e.g. #21568 for mysql), these expectations
will be updated to the real origin then.
andreiborza added a commit that referenced this pull request Jun 29, 2026
Under the SentryTracerProvider, streamed spans carry `sentry.origin` as a
first-class attribute including the default `manual` value, whereas the
OpenTelemetry SDK path omits the `manual` default. The `mysql` (v1) db spans
and the `pg.connect` span set no explicit origin, so they surface as
`manual` here.

Assert it for now. When those instrumentations are reworked to set an
explicit `auto.db.otel.*` origin (e.g. #21568 for mysql), these expectations
will be updated to the real origin then.
andreiborza added a commit that referenced this pull request Jun 30, 2026
Under the SentryTracerProvider, streamed spans carry `sentry.origin` as a
first-class attribute including the default `manual` value, whereas the
OpenTelemetry SDK path omits the `manual` default. The `mysql` (v1) db spans
and the `pg.connect` span set no explicit origin, so they surface as
`manual` here.

Assert it for now. When those instrumentations are reworked to set an
explicit `auto.db.otel.*` origin (e.g. #21568 for mysql), these expectations
will be updated to the real origin then.
andreiborza added a commit that referenced this pull request Jun 30, 2026
Under the SentryTracerProvider, streamed spans carry `sentry.origin` as a
first-class attribute including the default `manual` value, whereas the
OpenTelemetry SDK path omits the `manual` default. The `mysql` (v1) db spans
and the `pg.connect` span set no explicit origin, so they surface as
`manual` here.

Assert it for now. When those instrumentations are reworked to set an
explicit `auto.db.otel.*` origin (e.g. #21568 for mysql), these expectations
will be updated to the real origin then.
andreiborza added a commit that referenced this pull request Jun 30, 2026
Under the SentryTracerProvider, streamed spans carry `sentry.origin` as a
first-class attribute including the default `manual` value, whereas the
OpenTelemetry SDK path omits the `manual` default. The `mysql` (v1) db spans
and the `pg.connect` span set no explicit origin, so they surface as
`manual` here.

Assert it for now. When those instrumentations are reworked to set an
explicit `auto.db.otel.*` origin (e.g. #21568 for mysql), these expectations
will be updated to the real origin then.
andreiborza added a commit that referenced this pull request Jun 30, 2026
Under the SentryTracerProvider, streamed spans carry `sentry.origin` as a
first-class attribute including the default `manual` value, whereas the
OpenTelemetry SDK path omits the `manual` default. The `mysql` (v1) db spans
and the `pg.connect` span set no explicit origin, so they surface as
`manual` here.

Assert it for now. When those instrumentations are reworked to set an
explicit `auto.db.otel.*` origin (e.g. #21568 for mysql), these expectations
will be updated to the real origin then.
andreiborza added a commit that referenced this pull request Jun 30, 2026
Under the SentryTracerProvider, streamed spans carry `sentry.origin` as a
first-class attribute including the default `manual` value, whereas the
OpenTelemetry SDK path omits the `manual` default. The `mysql` (v1) db spans
and the `pg.connect` span set no explicit origin, so they surface as
`manual` here.

Assert it for now. When those instrumentations are reworked to set an
explicit `auto.db.otel.*` origin (e.g. #21568 for mysql), these expectations
will be updated to the real origin then.
andreiborza added a commit that referenced this pull request Jun 30, 2026
Under the SentryTracerProvider, streamed spans carry `sentry.origin` as a
first-class attribute including the default `manual` value, whereas the
OpenTelemetry SDK path omits the `manual` default. The `mysql` (v1) db spans
and the `pg.connect` span set no explicit origin, so they surface as
`manual` here.

Assert it for now. When those instrumentations are reworked to set an
explicit `auto.db.otel.*` origin (e.g. #21568 for mysql), these expectations
will be updated to the real origin then.
andreiborza added a commit that referenced this pull request Jul 1, 2026
Under the SentryTracerProvider, streamed spans carry `sentry.origin` as a
first-class attribute including the default `manual` value, whereas the
OpenTelemetry SDK path omits the `manual` default. The `mysql` (v1) db spans
and the `pg.connect` span set no explicit origin, so they surface as
`manual` here.

Assert it for now. When those instrumentations are reworked to set an
explicit `auto.db.otel.*` origin (e.g. #21568 for mysql), these expectations
will be updated to the real origin then.
andreiborza added a commit that referenced this pull request Jul 1, 2026
Under the SentryTracerProvider, streamed spans carry `sentry.origin` as a
first-class attribute including the default `manual` value, whereas the
OpenTelemetry SDK path omits the `manual` default. The `mysql` (v1) db spans
and the `pg.connect` span set no explicit origin, so they surface as
`manual` here.

Assert it for now. When those instrumentations are reworked to set an
explicit `auto.db.otel.*` origin (e.g. #21568 for mysql), these expectations
will be updated to the real origin then.
andreiborza added a commit that referenced this pull request Jul 2, 2026
Under the SentryTracerProvider, streamed spans carry `sentry.origin` as a
first-class attribute including the default `manual` value, whereas the
OpenTelemetry SDK path omits the `manual` default. The `mysql` (v1) db spans
and the `pg.connect` span set no explicit origin, so they surface as
`manual` here.

Assert it for now. When those instrumentations are reworked to set an
explicit `auto.db.otel.*` origin (e.g. #21568 for mysql), these expectations
will be updated to the real origin then.
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Streamline @opentelemetry/instrumentation-mysql

2 participants